home *** CD-ROM | disk | FTP | other *** search
/ CDV Game Power / CDV Game Power.bin / dosgames / demo / robin / install.doc < prev    next >
Encoding:
Text File  |  1992-09-01  |  28.6 KB  |  877 lines
  1.                         I N S T A L L  3 . 3 7
  2.                                    
  3.                           September 6, 1991
  4.                              Mark Wilden
  5.                                    
  6.  
  7.  
  8. This manual describes Install, a program that installs a program on a
  9. user's hard or floppy disk.  Install shows the user the hardware and
  10. software options it thinks are most suitable, asks for his
  11. confirmation of these choices, then runs a script which typically
  12. creates a subdirectory for the game on the user's hard disk and copies
  13. the necessary files to it.
  14.  
  15. This manual is updated regularly and is stored in ASCII format with
  16. the rest of Install, in the S:INSTALL directory
  17. (APPS/VOL1:/GAMES/SCI/SYSTEM/INSTALL).  See the last section "Changes"
  18. for a revision history.
  19.  
  20.  
  21. Starting Install
  22.  
  23. The user starts the Install program by logging onto the disk drive
  24. that contains the Install program and typing INSTALL.  After a pause
  25. to read files from the installation disk, an introductory screen is
  26. displayed.  The user can press ENTER at this screen to continue or ESC
  27. to cancel installation.
  28.  
  29.  
  30. Choosing a Destination Drive
  31.  
  32. The next screen asks the user to select which hard disk to install the
  33. game to.  Only drives C: and above are allowed (unless the FLOPPY=YES
  34. option is present--see below).  The user can press ESC to cancel
  35. installation at this point, or type a valid drive letter to continue.
  36.  
  37. The Install program will look on the hard disk specified to see if the
  38. game was previously installed, in which case the user's old choices
  39. will be used on the next screen.
  40.  
  41.  
  42. Confirming Installation Choices
  43.  
  44. The Installation Choices screen shows the user what hardware and
  45. software options it thinks are most suitable for running the game.  At
  46. this point the user can:
  47.  
  48.      Choose "View documention update in README file" (if there is a
  49.           file called README or READ.ME on the installation disk).
  50.      Choose "Accept these choices" to continue the installation,
  51.      Choose "Cancel installation" to return to DOS,
  52. Install 3.37                                         September 6, 1991
  53.  
  54.  
  55.      Press ESC to return to the previous screen (the destination drive
  56.           choice), or
  57.      Move the highlight to a choice and press ENTER to change it.
  58.  
  59. Changing an Installation Choice
  60.  
  61. If the user wants to change an installation choice, a menu is shown
  62. with the possible choices for that item on it.  In general, the
  63. choices will be listed in decreasing order of desirability.  A check
  64. mark is displayed beside each choice that the Install program has
  65. detected the user's machine can support.
  66.  
  67. The user can put the highlight on a given choice and press F1 to get
  68. help for that choice, if available.  In addition, some choices will
  69. bring up an additional screen of information if the user chooses it.
  70. If the user selects a choice that the program feels is not supported
  71. by his hardware, a warning message is displayed and the user is asked
  72. to confirm his choice.
  73.  
  74.  
  75. Installation Menus
  76.  
  77. Here are the specific installation choice menus for SCI games (TSN and
  78. CD games may have different screens).  If there is only one choice
  79. possible for a given type of option, the choice won't be displayed on
  80. the Installation Choices screen (such as the Video choice for a VGA-
  81. only game).
  82.  
  83. Video     This menu shows the video card and monitor choices.  The
  84.           Install program can detect what video card the user has, so
  85.           he should rarely have to use this menu to change the default
  86.           video choice.
  87.  
  88. Sound     Here is where the user selects what sound card to use.
  89.           Again, we can usually detect this, with the exception of the
  90.           Game Blaster card.  Also, we consider that the user has a
  91.           Roland card if he has any MIDI device attached.
  92.  
  93. Speech    This menu allows users of CD games to specify the driver to
  94.           use for speech and other CD audio.
  95.  
  96. Joystick  This menu allows the user to specify whether to use his
  97.           joystick or not.  We detect the presence of a joystick.
  98.  
  99. Mouse     We detect whether the user has a mouse, but this menu allows
  100.           him to choose not to have the game use it.
  101.  
  102. Memory    This menu lets the user turn off our use of his extra memory
  103.           (expanded, extended, XMS and/or extra video memory) if he
  104.           has any.  Pressing F1 at this menu shows the user which of
  105.           these types of extra memory he has, and how much of each is
  106.           available.
  107.  
  108.  
  109.                                                                 Page 2
  110.  
  111. Install 3.37                                         September 6, 1991
  112.  
  113.  
  114. Returning to Default Choices
  115.  
  116. If the user changes any of the choices Install suggested for him when
  117. the game was first installed, an additional choice will be available:
  118. "Return to Sierra defaults."  This lets him start over with a clean
  119. slate.
  120.  
  121.  
  122. Accepting Installation Choices
  123.  
  124. After the user chooses "Accept these choices" from the Installation
  125. Choices screen, he may be shown various information screens, such as a
  126. warning to turn off NUMLOCK before playing the game.  He can either
  127. press ENTER at these screens or ESC to go back and change the
  128. selection.
  129.  
  130.  
  131. Installing the Game
  132.  
  133. At this point, the game is actually installed on the user's hard disk
  134. by executing the installation script in INSTALL.SCR.  This script
  135. usually asks additional questions of the user depending on the
  136. individual game, checks the user's disk for sufficient free space,
  137. creates a subdirectory and copies the game files.  The installation
  138. floppy disk is not modified.  After the script has completed, the user
  139. presses a key to exit Install and proceeds to have fun.
  140.  
  141.  
  142. Installing Without Hardware Autodetection
  143.  
  144. When the Install program starts, it performs various tests to
  145. determine the user's hardware configuration.  It is conceivable that
  146. these tests could hang the user's machine.  In this event, the Install
  147. program can be started with the -m command line flag by typing
  148. INSTALL -m at the DOS prompt.  This flag disables autodetection.  The
  149. user will be presented with a sequence of menus from which to select
  150. his hardware configuration.
  151.  
  152. To enable autodetection selectively, follow the -m flag with a number
  153. specifying the autodetection desired:
  154.  
  155.      VIDEO       1
  156.      MUSIC       2
  157.      VOICE       4
  158.      JOYSTICK    8
  159.      KEYBOARD    16
  160.      COMM        32
  161.      MOUSE       64
  162.      MEMORY      128
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                                                                 Page 3
  169.  
  170. Install 3.37                                         September 6, 1991
  171.  
  172.  
  173. For example, to enable music autodetection only, use INSTALL -m2.  Add
  174. numbers together to enable more than one autodetection.  For example,
  175. to enable memory and video autodetection (128 + 1 = 129) use
  176. INSTALL -m129.  This option is available primarily for debugging
  177. purposes.
  178.  
  179.  
  180. Changing Configuration and Updating a Game
  181.  
  182. If the user needs to change his configuration after installing the
  183. game, he can run the Install program again from his hard drive.  He
  184. will not be asked which drive to install to, and his previous choices
  185. will be displayed for him to change.
  186.  
  187. In the case of updating a game from floppy, after selecting the drive
  188. to install to the old configuration will be presented for the user to
  189. change if necessary.
  190.  
  191.  
  192. Required Files
  193.  
  194. A typical game will require many different files, which are used
  195. during the installation process by INSTALL.SCR.  These will be
  196. resources, patches, batch files, etc.
  197.  
  198. The files required by the Install program itself are:
  199.  
  200. INSTALL.EXE    The program.
  201.  
  202. INSTALL.HLP    Besides help and information messages, this file also
  203.                contains the names of the driver files that are
  204.                displayed as menu choices.  The order of these entries
  205.                in the file determines the order of the menu choices.
  206.  
  207. INSTALL.TXT    This file contains the rest of the text displayed by
  208.                the program.  If either this file or INSTALL.HLP is not
  209.                found on the current drive, the Install program won't
  210.                be able to locate its text, and an error message will
  211.                be displayed.
  212.  
  213. INSTALL.SCR    This file contains the commands to actually copy a game
  214.                to a user's disk.  The Install program will run without
  215.                this file, but there wouldn't be much point.
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.                                                                 Page 4
  228.  
  229. Install 3.37                                         September 6, 1991
  230.  
  231.  
  232. The following is information of interest mainly to programmers.
  233.  
  234.  
  235. Menu Choices
  236.  
  237. Menus in general are created from the driver files found on the
  238. installation disk.  If there are no driver files of a given menu's
  239. type on disk (like CD speech, for example), no menu will be displayed
  240. and no choice will be recorded in RESOURCE.CFG.  If there is only one
  241. driver file (e.g. VGA320.DRV for a VGA-only game), the menu won't be
  242. displayed and that driver will be recorded in RESOURCE.CFG
  243. automatically.
  244.  
  245. The order of driver menu choices is determined by the order of the
  246. corresponding text entries in INSTALL.HLP.
  247.  
  248.  
  249. Help, Information and Warnings
  250.  
  251. There can be help and/or information for each menu choice.  A help
  252. entry is displayed when the user highlights the choice and presses F1.
  253.  
  254. An information entry is displayed when the user selects a choice by
  255. pressing ENTER on it.  In general, an information item is provided to
  256. warn the user of some condition (e.g. to turn off NUMLOCK in order to
  257. control Ego with the keypad cursor keys).  When the information is
  258. displayed, the user has the option of pressing ENTER to continue, or
  259. ESC to go back and change his choice.
  260.  
  261. If the user doesn't go to any of the individual menus to change the
  262. default choices, all appropriate information screens will be shown
  263. when he accepts the choices shown on the Installation Choices menu.
  264. This makes sure he sees all warnings.
  265.  
  266. There doesn't have to be help or information entries for all menu
  267. choices, though naturally help entries are desirable.
  268.  
  269.  
  270. Input Fields
  271.  
  272. TSN Install contains some screens that are input fields instead of
  273. menus.  Install will record the contents of these fields in the
  274. configuration file entry, rather than the name of a driver file.
  275.  
  276.  
  277. Viewing README
  278.  
  279. If a file by the name README or READ.ME is present, the user can view
  280. it from within the Install program.  The file should be formatted so
  281. that no lines are longer than 74 characters.  Tabs are not expanded.
  282.  
  283.  
  284.  
  285.  
  286.                                                                 Page 5
  287.  
  288. Install 3.37                                         September 6, 1991
  289.  
  290.  
  291. Text Files
  292.  
  293. Install stores all of the text it displays in the text files
  294. INSTALL.HLP and INSTALL.TXT, which must be included on the
  295. installation disk.  INSTALL.HLP contains help and information;
  296. INSTALL.TXT contains all the rest of the text displayed by the
  297. program.  These files have the format
  298.  
  299.      \\label
  300.      text
  301.      \\label
  302.      text
  303.      [etc...]
  304.  
  305. where label is an identifying string, and text is the actual
  306. information.  Case is not significant in label.  Whitespace after the
  307. backslashes and after the label is stripped, but whitespace within the
  308. label is significant.  Text can be as many lines as necessary.  Each
  309. line can be up to 2000 characters long and will normally be
  310. wordwrapped if necessary when displayed by the program.  A single line
  311. can be broken into separate lines if each line ends in a backslash.
  312. The backslash and newline will be deleted when read.
  313.  
  314. At startup, Install scans the installation disk for INSTALL.TXT and
  315. INSTALL.HLP, then for any other .TXT and .HLP files and adds their
  316. contents to its dictionary of text entries.  An entry for a given
  317. label overrides a previously defined entry.  Therefore, if you want to
  318. override an entry without changing the default files, simply include
  319. another .TXT or .HLP file with the new entries.
  320.  
  321. The labels for help, information and driver descriptions are of the
  322. form driver.hlp, driver.inf and driver.drv respectively, where driver
  323. represents the base name of the associated driver file or choice.  The
  324. description of the driver used as the text for a menu choice is no
  325. longer taken from the driver file itself but comes from the text file
  326. INSTALL.HLP.
  327.  
  328.  
  329. Configuration File
  330.  
  331. When the user chooses to accept the configuration on the Installation
  332. Choices menu, the choices are recorded in the RESOURCE.CFG file.  For
  333. each item, a line is recorded in this file showing the driver chosen.
  334. For example, the Video menu will create a line like
  335. videoDrv = VGA320.DRV.
  336.  
  337. Three menus act a little differently:  The Joystick menu will record
  338. either joyDrv = JOYSTICK.DRV or joyDrv = NO.  The Mouse menu will
  339. record either mouseDrv = STDMOUSE.DRV or mouseDrv = NO.  The Memory
  340. menu will record either memoryDrv = ARM.DRV or memoryDrv = NO.  Note
  341. that there are no driver files called STDMOUSE.DRV, ARM.DRV or NO.
  342.  
  343.  
  344.  
  345.                                                                 Page 6
  346.  
  347. Install 3.37                                         September 6, 1991
  348.  
  349.  
  350. The Sound menu (and Speech menu, if present) has an additional
  351. capability:  it can not only specify the sound driver, but can also
  352. specify the port number of the sound device, like soundDrv = MT32.DRV
  353. 34.  This port number must be in hex and can be specified in the form
  354. 34, $34, 0x34, or 34h.
  355.  
  356.  
  357. Command Script Language
  358.  
  359. If the user is running the Install program from a floppy drive (A: or
  360. B:) and the installation script file INSTALL.SCR is present, it will
  361. be executed.  INSTALL.SCR uses a language very similar to MS-DOS
  362. Batch, but with enhancements.  Typically, the installation script will
  363. display messages to the user, get input from him, check for sufficient
  364. disk space, create a subdirectory and copy files.
  365.  
  366. Three variables are passed to the script by the Install program:
  367.  
  368.      %1, which is replaced by the destination drive
  369.      %2, which is replaced by the installation source drive
  370.      %3, which is replaced by the contents of RESOURCE.CFG.
  371.      
  372. The trailing colon is not included in the drive parameters--you must
  373. supply it when you use the parameter in the script file.
  374.  
  375. If the user is installing from floppy disk (as opposed to a reinstall
  376. from the hard disk in order to change options), it is the
  377. responsibility of the script file to create RESOURCE.CFG in the
  378. appropriate directory on the user's hard disk.  It can't simply be
  379. copied from the floppy disk, since it isn't written there.  The
  380. following command is necessary to create RESOURCE.CFG
  381.  
  382.      echo %3>resource.cfg
  383.  
  384. and should be included in the section of the script file where other
  385. files are copied from the floppy disk to the user's hard disk.  This
  386. approach eliminates writing to the floppy disk, which users object to,
  387. and also conforms to situations where the installation disk can't be
  388. written to, like CD-ROM products.
  389.  
  390.  
  391. Sample Installation Script
  392.  
  393. Following is a sample INSTALL.SCR with annotations.  It is intended
  394. for tutorial purposes only; the actual script will be dictated by your
  395. game's needs.
  396.  
  397. echo You may Install one of two ways:
  398. echo
  399.      Unlike DOS, an echo command with no parameters will output a
  400.      blank line.
  401. echo SMALL install will only install the STARTUP DISK to your
  402.  
  403.  
  404.                                                                 Page 7
  405.  
  406. Install 3.37                                         September 6, 1991
  407.  
  408.  
  409. echo hard drive. You MUST play from floppies.
  410. echo Approximate hard drive space required:  1.2 Meg
  411. echo
  412. echo COMPLETE install will install all files to your hard drive.
  413. echo The entire game will be played from a hard drive.
  414. echo Approximate hard drive space required:  6.0 Meg
  415. echo
  416. echo Would you like to install (S)mall, (C)omplete or (E)xit?
  417. pick sce small large Exit
  418.      This command allows the user to type s, c or e (upper or lower
  419.      case), then branches to the first label (small) if the first key
  420.      (s) was typed, the second label if the second key was typed, etc.
  421.  
  422. :small
  423. cls
  424. space %1: 1200 NoSpace
  425.      This command checks that the user has enough space on drive %1
  426.      (the destination drive) for the game (in this case, 1200 K) and
  427.      goes to the NoSpace label if he doesn't.
  428. godir %1:\sierra\sq4 CantCreate
  429.      godir creates the directory specified and changes to it (going to
  430.      the CantCreate label if the directory can't be created or changed
  431.      to).
  432.  
  433.      This section will differ depending on the game, but note the
  434.      creation of RESOURCE.CFG.
  435. echo Copying Startup Files ...
  436. copy %2:*.drv
  437. copy %2:*.hlp
  438. copy %2:*.txt
  439.      Make sure you copy all the .TXT and .HLP files to the hard disk,
  440.      or else the user won't be able to run the install program again
  441.      from there.
  442. copy %2:version
  443. copy %2:scidhuv.exe
  444. copy %2:resource.000
  445. copy %2:resource.map
  446.  
  447. echo %3 > resource.cfg
  448.  
  449. copy %2:install.exe
  450. copy %2:sq4rs.bat %1:\sq4.bat
  451. copy %2:sq4rs.bat %1:\sierra\sq4.bat
  452. copy %2:sq4.bat
  453. copy %2:sierra.bat
  454. goto exit
  455.  
  456. :large
  457. clear
  458. space %1: 6000 NoSpace
  459. godir %1:\sierra\sq4     CantCreate
  460. echo Copying Startup Files ...
  461.  
  462.  
  463.                                                                 Page 8
  464.  
  465. Install 3.37                                         September 6, 1991
  466.  
  467.  
  468. copy %2:*.drv
  469. copy %2:*.hlp
  470. copy %2:*.txt
  471. copy %2:version
  472. copy %2:scidhuv.exe
  473. copy %2:resource.000
  474. copy %2:resource.map
  475. echo %3 > resource.cfg
  476.  
  477. copy %2:install.exe
  478. copy %2:sq4rs.bat %1:\sq4.bat
  479. copy %2:sq4rs.bat %1:\sierra\sq4.bat
  480. copy %2:sq4h.bat sq4.bat
  481. copy %2:sierrah.bat sierra.bat
  482.  
  483. echo Copying Game files...
  484.      These lines copy the resource files from each disk to the hard
  485.      disk, checking to see if the file exists in the source floppy
  486.      drive before prompting the user to insert it.
  487. exists %2:resource.001 Insert Disk 1 in drive %2:.
  488. copy %2:resource.001
  489. exists %2:resource.002 Insert Disk 2 in drive %2:.
  490. copy %2:resource.002
  491. exists %2:resource.003 Insert Disk 3 in drive %2:.
  492. copy %2:resource.003
  493. exists %2:resource.004 Insert Disk 4 in drive %2:.
  494. copy %2:resource.004
  495. exists %2:resource.005 Insert Disk 5 in drive %2:.
  496. copy %2:resource.005
  497.  
  498. :exit
  499. clear
  500. echo
  501. echo  To play NOW:
  502. echo     Type SQ4 [ENTER].
  503. echo
  504. echo  To play LATER:
  505. echo     From the root directory of %1:,
  506. echo     Type SQ4 and press [ENTER].
  507. echo
  508. pause
  509. end
  510.  
  511. :NoSpace
  512. clear
  513. echo
  514. echo There is not enough space on %1: to install Space Quest IV!
  515. rem determine which message to bring up.
  516. space %1: 1200 NoSmall
  517. echo 6.0 megabytes of disk space are necessary.
  518. echo
  519. echo SMALL install will only install the STARTUP DISK
  520.  
  521.  
  522.                                                                 Page 9
  523.  
  524. Install 3.37                                         September 6, 1991
  525.  
  526.  
  527. echo to your hard drive. You MUST play from floppies.
  528. echo SMALL install is recommended, due to insufficient
  529. echo hard drive space.
  530. echo
  531. echo Would you like to install (S)mall or (E)xit?
  532. pick se small Exit
  533.  
  534. :NoSmall
  535. alert 1.2 megabytes of disk space are necessary.
  536. end
  537.  
  538. :Exit
  539. end
  540.  
  541. :CantCreate
  542. alert Unable to create directory %1:\sierra\sq4
  543. end
  544.  
  545.  
  546.  
  547. Script Command Reference
  548.  
  549. The commands available in this language are:
  550.  
  551.  
  552. ALERT message
  553.  
  554.      Opens an alert window, displays message, and allows the user to
  555.      press ENTER to continue, or ESC to exit Install.
  556.  
  557.  
  558. CLEAR
  559. CLS
  560.  
  561.      Clears the message window.
  562.  
  563.  
  564. COPY sourceSpec [destSpec]
  565.  
  566.      Copies a file or group of files.  Wildcards are permitted.  If no
  567.      destSpec is supplied, copies to the current directory, which is
  568.      usually the destination of the install, following a GODIR
  569.      command.
  570.  
  571.  
  572. DEL fileSpec
  573.  
  574.      Deletes a file or group of files.  Wildcards are permitted.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.                                                                Page 10
  582.  
  583. Install 3.37                                         September 6, 1991
  584.  
  585.  
  586. ECHO text [> or >> file]
  587.  
  588.      With no redirection (> or >>) this command displays text to the
  589.      user.  The redirection symbols allow writing or appending text to
  590.      a file.  This is needed to create the batch file that runs the
  591.      game, since this batch file should include a command to change to
  592.      the correct drive.
  593.  
  594.  
  595. END
  596.  
  597.      Ends the script.
  598.  
  599.  
  600. EXISTS fileName alertMessage
  601.  
  602.      If filename doesn't exist, does an ALERT with alertMessage,
  603.      allowing the user to either put in the correct disk or exit
  604.      Install.
  605.  
  606.  
  607. GODIR path label
  608.  
  609.      Attempts to change directory to path, creating path if necessary.
  610.      If unsuccessful, goes to label.
  611.  
  612.  
  613. GOTO label
  614.  
  615.      Considered harmful (just kidding).
  616.  
  617.  
  618. IF [NOT] ERRORLEVEL value command
  619.  
  620.      Compares the number value to the return value of the last program
  621.      executed.  If the return value was greater than or equal to
  622.      value, command is executed.  NOT reverses this logic.  command
  623.      can be any valid script command.
  624.  
  625.  
  626. PAUSE [message]
  627.  
  628.      If message is not specified, Press a key to continue... is
  629.      displayed.
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.                                                                Page 11
  641.  
  642. Install 3.37                                         September 6, 1991
  643.  
  644.  
  645. PICK letters choice1 choice2 choice3 choice4
  646.  
  647.      Gets a keypress from the user, and branches to the appropriate
  648.      choice.  For example, if the command was
  649.           PICK abcd aChoice bChoice cChoice dChoice
  650.      and the user typed a C, the script would goto the label cChoice.
  651.      Case is not significant for keypresses.
  652.  
  653.  
  654. SPACE drive kilobytes label
  655.  
  656.      Tests that drive has kilobytes free; if not, goes to label.
  657.  
  658.  
  659. TESTDIR path
  660.  
  661.      Tests to see if path contains any files (like those from a
  662.      previous install).  If so, confirms that user wants to continue
  663.      installation.
  664.  
  665.  
  666. Labels
  667.  
  668. The GODIR, GOTO, PICK, and SPACE commands can cause execution to
  669. branch to a label.  As in DOS Batch, a label is a word on a line by
  670. itself with a colon in front of it.
  671.  
  672.  
  673. Running External Programs
  674.  
  675. The installation script can run external programs by simply using its
  676. name, followed by any parameters (including %1, %2 or %3 that Install
  677. provides).  The program name does not have to include an extension,
  678. and if no path is included in the name, the PATH environment variable
  679. will be used to find the program.
  680.  
  681. If the program is a .COM or .EXE file, it is run directly by the
  682. Install program.  This means that redirection is not possible.  On the
  683. other hand, running an executable program sets ERRORLEVEL (see above
  684. under the IF command to see how ERRORLEVEL is used).
  685.  
  686. If Install can't find the program to run, it calls the command
  687. processor (e.g. COMMAND.COM) to run it.  This allows batch files and
  688. internal DOS commands to be run, and supports redirection, but always
  689. sets ERRORLEVEL to 0, regardless of the actual return value of the
  690. program.
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.                                                                Page 12
  700.  
  701. Install 3.37                                         September 6, 1991
  702.  
  703.  
  704. Default Configuration File
  705.  
  706. A default configuration file can be included on the installation disk.
  707. This file can include default entries, no-default entries, a directory
  708. entry, a floppy entry and/or other game-specific constant information.
  709.  
  710. There can be constant information in the default configuration file
  711. that the Install program doesn't change, use or even know about.  One
  712. such entry is minHunk = 1000k (e.g.).  Install will simply add any
  713. entries it doesn't understand to the installed configuration file.
  714. Install also adds any default, no-default and directory entries to the
  715. installed configuration file.
  716.  
  717. Much of the following applies only to TSN.
  718.  
  719. For most of the choices in the Install program, autodetection provides
  720. appropriate defaults.  But for TSN, e.g., the choice of a default
  721. modem prefix string can be specified by a line in the default
  722. configuration file of the form default prefix = ATZ~!.  ATZ~! will be
  723. the default prefix the user sees when he first installs TSN.  He can
  724. also revert to that prefix by selecting "Return to Sierra defaults"
  725. from the Installation Choices screen.  Default entries are not
  726. currently needed for other Sierra games.
  727.  
  728. It can sometimes be necessary to require the user to make a decision,
  729. rather than simply giving him a default choice.  This can be effected
  730. by including a line in the default configuration file of the form
  731. default touchtone = none (for the touchtone choice).  This ensures
  732. that the touchtone choice menu will be displayed to the user when he
  733. runs the Install program.  Anytime it is necessary to force the user
  734. to make an explicit choice a no-default entry should be included in
  735. the default configuration file.
  736.  
  737. When updating a game from an update floppy (as is done for TSN) it is
  738. desirable to show the user his previous choices.  To do this, a line
  739. of the form directory = \tsn should be included in the default
  740. configuration file.  This would instruct the Install program to look
  741. in the \tsn directory for a previous configuration file.
  742.  
  743. Normally, Sierra games can't be installed to a floppy drive, and the
  744. Install program won't allow drives A: or B: to be selected as the
  745. destination of the install.  However, including the line floppy = yes
  746. in the default configuration file will allow installation to a floppy.
  747. If the destination floppy drive is the same as the installation drive,
  748. the installation script won't be executed; only the configuration file
  749. will be written.
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                                                                Page 13
  759.  
  760. Install 3.37                                         September 6, 1991
  761.  
  762.  
  763. Changes History
  764.  
  765. 3.37  9/6/91   Fixed YATB (Yet Another Tandy Bug) where the Tandy
  766.                would hang while detecting extended memory if there is
  767.                none.
  768.                
  769.                Made right window shadow narrower if in greater than
  770.                25-line mode to match size of bottom shadow.
  771.                
  772.                If an external command is redirected, don't clear
  773.                screen.
  774.  
  775. 3.36  9/4/91   Help for TSN phone number views a file containing phone
  776.                numbers.
  777.  
  778. 3.35  8/29/91  Wasn't getting text for joystick menu label from
  779.                INSTALL.HLP.
  780.  
  781. 3.34  8/28/91  Fixed video display routines to be compatible with
  782.                UltraVision.
  783.  
  784. 3.33  8/20/91  Clear screen on abort from critical error.
  785.  
  786. 3.32  8/19/91  Added ability to execute external programs and test
  787.                their return value with new IF ERRORLEVEL command.
  788.  
  789.                Fixed bug where port wasn't appended to sound and audio
  790.                configuration lines.
  791.  
  792. 3.31  8/2/91   Made command log window larger.
  793.  
  794. 3.30  7/31/91  Major rewrite of display and window handling routines.
  795.                The display speed is considerably faster.  A few
  796.                windows use different colors.  Converted to large
  797.                memory model, which has made the program bigger.
  798.  
  799. 3.22  7/17/91  Improved error message when a text entry isn't found.
  800.  
  801. 3.21a 7/17/91  (TSN only) New comm port detection.
  802.  
  803. 3.21  7/16/91  Added option to view README file.
  804.  
  805.                When checking for extended memory capability and 0 is
  806.                reported free, see if someone else might be using it;
  807.                otherwise, say the user doesn't have extended memory
  808.                capability.  Takes care of cosmetic problem where a
  809.                '286 with no extended memory allows user to "use extra
  810.                memory" (even though the game would not actually try to
  811.                use it).
  812.  
  813.  
  814.  
  815.  
  816.  
  817.                                                                Page 14
  818.  
  819. Install 3.37                                         September 6, 1991
  820.  
  821.  
  822. 3.20  7/15/91  Converted to compact model to make more memory
  823.                available.  This increased the size of the program by
  824.                about 11,500 bytes.
  825.  
  826. 3.15           Fixed bug where a Tandy with no extended memory could
  827.                report a bogus amount.
  828.  
  829. 3.14           Fixed bug where a file created by redirection could be
  830.                read-only.
  831.  
  832. 3.13           Fixed some bugs having to do with long text messages
  833.                (observed when testing Spanish language version).
  834.                Improved detection of full target disk.
  835.  
  836. 3.12           Made the order of driver menu choices dependent on the
  837.                order of the associated entries in INSTALL.HLP.
  838.  
  839.                Added autodetection for audio (Chris Smith).
  840.  
  841. 3.11           Added floppy = yes entry to default config file.
  842.  
  843. 3.10           Moved all text into text file(s).
  844.  
  845. 3.00           Show menu of default choices.  Read existing config
  846.                file.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.                                                                Page 15
  877.